/**
 * 
 */
package com.nari.baseinfo.service;

import java.util.Date;
import java.util.List;
import java.util.Map;

import com.nari.baseinfo.model.IProject;
import com.nari.basic.model.IUser;
import com.nari.coreframe.service.IGenericService;
import com.nari.platform.model.PageCond;
import com.nari.platform.model.ResponseMsg;
import com.nari.platform.model.ResultWithPageCond;

/**
 * 
 * @author Xiaopeng
 * @date 2013-8-1
 */
public interface IProjectService extends IGenericService<IProject, String> {
	
	/**
	 * 分页查询项目列表
	 * @param projectID 项目编号(可选)
	 * @param projectName 项目名称(可选)
	 * @param capitalCityID 所属市级机构ID(可选)
	 * @param provinceCityID 所属省级机构ID(可选)
	 * @param projDate 施工日期(可选)
	 * @param pageCond
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2013-8-5
	 */
	public ResultWithPageCond<IProject> queryProjectWithPageCond(String projectID, String projectName, 
			String capitalCityID, String provinceCityID, Date projDate, PageCond pageCond) throws Exception;
	
	/**
	 * 分页查询项目列表
	 * @param projectID 项目编号(可选)
	 * @param projectName 项目名称(可选)
	 * @param capitalCityUID 所属市级机构UID(可选)
	 * @param provinceCityUID 所属省级机构UID(可选)
	 * @param projDate 施工日期(可选)
	 * @param pageCond
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2014-5-14
	 */
	public ResultWithPageCond<IProject> queryAuthorityProjectWithPageCond(String projectID, 
			String projectName, String capitalCityUID, String provinceCityUID, Date projDate, 
			PageCond pageCond) throws Exception;
	
	/**
	 * 通过项目列表查询与之关联的行政机构ID-机构名称映射表
	 * @param projectList 项目列表，若列表为空，则返回空的映射表
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2013-8-6
	 */
	public Map<String, String> queryReferCitysByProjList(List<IProject> projectList) throws Exception;
	
	/**
	 * 查询所有项目信息，并对结果集排序
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2013-8-8
	 */
	public List<IProject> queryAllProjectInOrder() throws Exception;
	
	/**
	 * 通过所属城市查询项目列表
	 * @param provinceCityID 所属省级机构
	 * @param capitalCityID 所属市级机构
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2013-8-25
	 */
	public List<IProject> queryProjectsByBelongCity(String provinceCityID, 
			String capitalCityID) throws Exception;
	
	/**
	 * 通过唯一标识列表查询项目信息
	 * @param idList 唯一标识列表，若为空列表，则结果集返回空
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2013-8-9
	 */
	public List<IProject> queryProjectsByIDList(List<String> idList) throws Exception;
	
	/**
	 * 根据项目ID级联删除关联信息
	 * 包括：项目、小区、楼栋、单元、热用户、系统用户及角色、集中器、热量表、分配表、散热器、
	 * 分摊域、分摊域分摊账单、用户分摊账单
	 * 注意：热量表数据、分配表数据等表计数据具有不可恢复性，因此不能作为级联删除的对象
	 * @param projectUID
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2014-1-13
	 */
	public void deleteCascadeByProjectUID(String projectUID) throws Exception;
	
	/**
	 * 统计项目编号重复的个数
	 * @param projectID
	 * @param projectUID
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2013-11-24
	 */
	public int countRepeatProjectIDNum(String projectID, String projectUID) throws Exception;
	
	/**
	 * 查询系统中的项目管理员用户列表
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2014-1-23
	 */
	public List<IUser> queryProjManagerList() throws Exception;
	
	/**
	 * 新增或修改项目信息
	 * @param project
	 * @param projManagerHandler 人工录入的项目管理员
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2014-1-23
	 */
	public ResponseMsg saveOrUpdateProject(IProject project, String 
			projManagerHandler) throws Exception;
	
	/**
	 * 删除项目管理员
	 * @param projectUID
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2014-5-19
	 */
	public ResponseMsg deleteProjectManager(String projectUID) throws Exception;
	
	/**
	 * 设置项目管理员
	 * @param projectUID
	 * @param userUID
	 * @return
	 * @throws Exception
	 * @author Xiaopeng
	 * @date 2014-5-19
	 */
	public ResponseMsg saveProjectManager(String projectUID, String userUID) throws Exception;
}
